                
                FILE 2.0 (C) 1994 by Dean R. Madsen, KE0WO


        After numerous requests for an alternative to PICK for automatic
filing of messages,  I have finally found time to create such a program.
Hopefully those that have had little luck getting PICK to function will have
an easier time with FILE.


Features:

Selects messages based on any combination of: the message type, the "From" 
field,  The "To" field, the "@BBS" distribution field, the message bid, and/or
the message subject.

The * wildcard is allowed ( *word,  word*,  *word*).

Eleven (11) file naming options are supported for files created from selected
messages.

Files go to user settable directories.

Reads the INIT.SRV file so you don't have to tell the program where the mail
files are or your callsign, etc.

The same message may be archived for each search line it qualifies for.

An index file may be created.

Files maybe added to the YAPPLBL.SYS with a label.

The R: forwarding headers may be omitted from the saved files.



Uses:

Archive personal mail for later reference...

Archive locally generated messages for record keeping/possible
license protection in the US (read "It Seems to Us" in June(?) '94 QST).

Allows informational bulletins to be automatically added to file sections.
(ie: ARRL bulletins, RACES bulletins, regional network bulletins.



-----------------------------Installation--------------------------------

The only requirement is that all the FILE.* files are located in the same
directory and the FBB 5.15 INIT.SRV is either in the current directory or in
the \FBB directory of the same drive.

-----------------------------FILE.ADD------------------------------------
The contents of this file is added to the beginning of each message archived
by FILE.  If the file doesn't exist, or contains no text, nothing is added.
-----------------------------INDEX.FIL--------------------------------------
The contents of the INDEX.FIL becomes each line in the index file.
-----------------------------variables--------------------------------------

To permit everyone to tailor this file to their liking, I have implemented
variables to have the FILE program include variable info into the file.
Each variable must begin with a $ and be in lower case.


Variables:

$@        - @BBS field of message being archived.
$@_       - @BBS field formatted to 7 characters.
$thisbbs  - Callsign as found in INIT.SRV.
$to       - "To" field of message being archived.
$to_      - "To" field formatted to 7 characters.
$type     - type of message being archived.
$from     - "from" field of message being archived.
$from_    - "from" field formatted to 7 characters.
$date     - date of message origination in the YYMMDD format
$dateusa  - date of message origination in the U.S. MM/DD/YY format.
$dateeu   - date of message origination in the DD/MM/YY format that everyone 
            else uses.
$time     - time of message origination (hh:mm)
$msize    - size of message/file created from the message.
$bid      - the BID/MID of the message being archived.
$bid_     - the BID/MID formatted to 13 characters.
$subject  - the subject of the message being archived.
$filename - Name of the file the messages is currently being saved to.
$filename_- Name of the file formatted to 14 characters.

------------------------------FILE.CFG--------------------------------------
This is the file where you setup messages to be archived, etc.  All lines
begining with a # are considered comment lines.  Fields are separated by
commas (,).  Currently there is a limit of 173 search lines.  When I tried
to get it set higher I get an error message from my compiler.  This is an area
for improvement in any future versions.  THERE MUST BE NO SPACES _EXCEPT_ IN 
THE SUBJECT SEARCH FIELD!

      
again:    THERE MUST BE NO SPACES _EXCEPT_ IN THE SUBJECT SEARCH FIELD!

The line format is:

Type,From,@BBS,TO,BID/MID,SUBJECT,Drive:\PATH\,Save method,Indexing

For right now I will forget the last field (save method) and explain it later.

Examples:

# Archive all Bulletin type mesages.
B,*,*,*,*,*,C:\BULLETIN\,1,1
# Archive all messages from KE0WO
*,KE0WO,*,*,*,*,C:\KE0WO\,1,1
# Archive all messages with the @ distribution of IOWA
*,*,IOWA,*,*,*,C:\IOWA\,1,1
# Archive all messages to KE0WO
*,*,*,KE0WO,*,*,C:\KE0WO\,1,1
# Archive all messages with a BID/MID ending in _KE0WO  (all messages originated
# on KE0WO BBS)
*,*,*,*,*_KE0WO,*,C:\LOCAL\,1,1
# Archive all messages with the string (case insensitive) "NOAM" in the subject
#  Result:  Archive most of the NA vs. NOAM debate messages.
*,*,*,*,*,*NOAM*,C:\NOAMVSNA\,1,1


Then you can start combining things to be most specific in message selection:


# Archive all messages sent to FBB @ ALLUS from anyone with the prefix "KE"
*,KE*,ALLUS,FBB,*,*,C:\FBBSTUFF,1,1
# Archive all personal messages to SYSOP with the work "ILLEGAL" in the subject
P,*,*,SYSOP,*,*ILLEGAL*,C:\SYSOP\,1,1
# Archive all Bulletins messages from KE0BX to MAP* with the distribution of
# IOWA
B,KE0BX,IOWA,MAP*,*,*,C:\FILES\MAPS\,1,1


Now for the file naming options:

1   -   Save by local message number  (message # 100101 becomes file 100101.)
2   -   Save by BID/MID
3   -   Save by name specified in the directory field.  If C:\FILES\STUFF,3
        is the directory/save number.  Messages will be saved as 
        C:\FILES\STUFF.001 to C:\FILES\STUFF.999
4   -   Save into name.ext (append messages).  If C:\FILES\STUFF.TXT,3
        is the directory/save number.  Messages will be saved as 
        C:\FILES\STUFF.TXT (later messages being appended to the file).
5   -   Name files using the "From" field of the message being archived.
        Use the extensions .001 - .999
6   -   Name files using the "From" field of the message being archived.
        Append later messages.
7   -   Name files using the "to" field of the message being archived.
        Use the extensions .001 - .999
8   -   Name files using the "to" field of the message being archived.
        Append later messages.
9   -   Name files using the "@bbs" field of the message being archived.
        Use the extensions .001 - .999
0   -   Name files using the "@bbs" field of the message being archived.
        Append later messages.
10  -   Name files using the current date in the YYMMDD format.
        Append later messages.
           
The indexing options:

0   -   No indexing.
1   -   Create an ASCII index file only
2   -   Add the file to the YAPPLBL.SYS only so it shows up when the LIST 
        command is used.
3   -   Create an ASCII index file AND add the file with label to the
        YAPPLBL.SYS.
4   -   No indexing.  Remove R: forwarding headers.
5   -   Create an ASCII index file only and remove R: forwarding headers.
6   -   Add the file to the YAPPLBL.SYS only so it shows up when the LIST
        command is used and remove R: forwarding headers.
7   -   Create an ASCII index file And add the file with lavl to the
        YAPPLBL.SYS and remove R: forwarding headers.

------------------------------FILE.REJ--------------------------------------
This is basically the REJECT.SYS of the FILE program.  When a match is made
according the settings of FILE.CFG.  FILE looks for a match with the contents
of FILE.REJ,  if it finds a match again, the message WILL NOT be archived.
If FILE.REJ does not exist, then all message matching the FILE.CFG will be
archived.

The line format is:

Type,From,@BBS,TO,BID/MID,SUBJECT

Note this is ALMOST the same as FILE.CFG.


-------------------------Where to I run this?----------------------

In previous programs (REPORT) I assumed that people would realize you run this
type from APPEL.BAT, but from the questions I have received, I should state
that FILE should be run in the APPEL.BAT housekeeping section BEFORE the
EPURMESS program.

------------------------------ BUGS? -------------------------------
   

   $m               mm            m        So far I have found the program
    "$mmmmm        m$"    mmmmmmm$"        works fine.  The ONLY problem I
          """$m   m$    m$""""""           can think of is with the naming
        mmmmmmm$$$$$$$$$"mmmm              files by BID/MID.  BID/MIDs can
  mmm$$$$$$$$$$$$$$$$$$ m$$$$m  "    /     be longer than DOS file name as
$$$$$$$$$$$$$$$$$$$$$$  $$$$$$"$$$ /       well as contain characters that
 mmmmmmmmmmmmmmmmmmmmm  $$$$$$$$$$         DOS can't handle in file names..
 $$$$$$$$$$$$$$$$$$$$$  $$$$$$$""" \       I did take some steps to compensate,
 "$$$$$$$$$$$$$$$$$$$$$ $$$$$$  "    \     but I am sure I didn't cover 
     """""""$$$$$$$$$$$m """"              everything.  This is an area of
       mmmmmmmm"  m$   "$mmmmm             improvement for future versions.
     $$""""""      "$     """"""$$
   m$"               "m           "        Another problem may be that the number
                       "                   of seconds since Jan.  1, 1970
                                           is getting larger,  it may get
                                           high enough to cause problems due
                                           the short comings of my compiler.
                                           Usually a run-time error 215 will
                                           signal this happening.  To circumvent
                                           this,  disable the updating of the
                                           YAPPLBL.SYS file throughout the
                                           FILE.CFG.

---------------------Something I almost forgot to mention------------------

So the program doesn't archive the same messages next time it is run,  the
file FILE.NUM is created to keep track of the last message the program
processed.  Delete it and the program will look through all messages and then
recreate the file.

------------------------------- Conclusion ---------------------------------


1. This software is freeware to the amateur community. It may not be sold.
   It may be freely copied and distributed, but at no charge exceeding the
   medium and shipping.  Commericial use of this software is prohibited
   without licensing from the author.

2. No warranty is expressed or implied and incidental damages resulting from
   the use of this software are solely the responsibility of the user. While
   the software works fine, and I am willing to release it to the amateur 
   community, I am not willing to assume any liabilty for it crashing your
   computer or its peripherals. (It has not done that on any machine I have
   ran it on...this is just legal junk to prevent someone from holding me
   responsible for being generous enough to produce this utility as a 
   service to the FBB community.)

3. Feedback on desired features, bugs, etc. are encouraged. 

4. I have given up on the "send money" type message that used to go here.
   Instead,  how about helping your fellow amateur instead of flaming him?
   If you can make this hobby more enjoyable for others,  then that follows
   the spirit with which my programs are made.  For this, I say "Thank You!".

5. I expect that my release will be UNALTERED.  If I connect to a board and
   find this software package, I expect it to be unchanged and named
   FILE20.EXE.  I don't want to see it as FILE20.ARJ or another name.
   If I take the time to release this software, the least you can do is not 
   change it.




If you have any problems, questions, comments, etc. you can contact me via:

Telephone: 
 
        Home:     (712) 732-2021

        College:  (515) 296-9471    (later part of August, until first part
                                     of December excluding the week long
                                     Thanksgiving break in November.  Second 
                                     semester begins later part of January 
                                     and ends in the first part of May with 
                                     a week long spring break in there 
                                     somewhere.  Some weekends I may be home.
                                     If in doubt, you can call my home # and my
                                     parents will tell you how to reach me.)


U.S. Mail:

        Home:     Dean R. Madsen
                  P.O. Box 303
                  Storm Lake, IA  50588
                  USA

        College:  Dean R. Madsen
                  Wallace 7348 Lancelot
                  Iowa State University
                  Ames, IA  50013
                  USA

Data :    (712)  732-3767  -   14400,N,8,1 .   Enter your call at the prompt,
                               then type Y to proceed.  
                               Latest KE0WO servers/utilities in the SERVERS
                               subdirectory of my file section in FBBDOS.

Internet:         dmadsen@iastate.edu

Internet FTP:                  I will try tohave my latest stuff available on my
                               my Internet FTP site for those that want the
                               latest works, or would like to test beta
                               software that I may be working on.
                               FTP vincent.iastate.edu   and login as
                               anonymous.dmadsen  then sent your email
                               address as your password.  I will try to 
                               set up some sort of logical directory
                               structure in the near future.  I plan to have
                               my servers in the directory ke0wo and beta
                               versions in the beta directory.

                               I will also try to get my servers to
                               FTP.FUNET.FI somewhere in the
                               /pub/ham/packet/bbs/f6fbb subdiretories.


Packet Radio:     KE0WO @ KE0WO.#NWIA.IA.USA.NA


Hope you find this software useful,
73,
Dean - KE0WO

